home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / files / proctab.doc < prev    next >
Encoding:
Text File  |  1992-11-19  |  4.5 KB  |  104 lines
  1.  
  2.  
  3.  
  4.  
  5.      PROCTAB(FILES)                                     PROCTAB(FILES)
  6.  
  7.  
  8.  
  9.      NAME
  10.           .../files/proctab8 - INGRES runtime  configuration  informa-
  11.           tion
  12.  
  13.      DESCRIPTION
  14.           The process table describes the runtime configuration of the
  15.           INGRES system.  Each line of the process table has a special
  16.           meaning depending on the first character of the line.  Blank
  17.           lines  and  lines  beginning  with an asterisk are comments.
  18.           All other lines have a sequence of fields separated by  com-
  19.           mas.   Pipe  descriptor fields are lower case letters or di-
  20.           gits; if they are digits they are replaced by file  descrip-
  21.           tors from the  flag or the @ flag.
  22.  
  23.           _D defines a macro.  The first field is  a  single  character
  24.           macro  name.   The  second field is the string to use as the
  25.           value.  Macros are expanded using ``$_x'' where _x is the mac-
  26.           ro  name.   The macro ``P'' is predefined to be the pathname
  27.           of the INGRES subtree.
  28.  
  29.           _P introduces a process description.  All lines up to an  end
  30.           of  file  or  another P line describe a single process.  The
  31.           first field is the process number.  The next  field  is  the
  32.           pathname  of  the  binary  to execute for this process.  The
  33.           third field is the name of the process to use  for  printing
  34.           messages.  The fourth field must be a single character lower
  35.           case letter representing the input  pipe  that  is  normally
  36.           read  when  nothing  special is happening, or a vertical bar
  37.           followed by a single digit, meaning to read from  that  file
  38.           descriptor.   The  next field is a set of flags in octal re-
  39.           garding processing of  this  process;  these  are  described
  40.           below.   The  final  field  is  a single letter telling what
  41.           trace flag this process uses.
  42.  
  43.           _L defines what modules are defined locally by this  process.
  44.           The  first  field is the module number used internally.  The
  45.           second field is a set of flags describing processing of this
  46.           module:  the  only  bit defined is the 0001 bit which allows
  47.           this module to be executed directly by the user.  The  third
  48.           field  is  the  function number in the process which defines
  49.           this module.  The final field is the module number to be ex-
  50.           ecuted  after  this  module  completes; zero is nothing (re-
  51.           turn).
  52.  
  53.           _R defines modules that are known to this process  but  which
  54.           must  be passed to another process for execution.  The first
  55.           field is the process number the modules will  be  found  in.
  56.           The  second  field  is the pipe to write to get to that pro-
  57.           cess.  The third field is the pipe to read to get a response
  58.           from that process.  The fourth field is a set of flags: 0001
  59.           means to write the output pipe if you get a  broadcast  mes-
  60.           sage,  0002 means that the process is physically adjacent on
  61.           the read pipe, and 0004 means that the process  is  adjacent
  62.           on  the write pipe.  The fifth and subsequent fields are the
  63.           module numbers that are defined by this process.
  64.  
  65.           The status bits for the _P line are as follows:
  66.  
  67.                   000010  close diagnostic output
  68.                   000004  close standard input
  69.                   000002  run in user's directory, not database
  70.                   000001  run as the user, not as INGRES
  71.  
  72.  
  73.           The lowest numbered process becomes the parent  of  all  the
  74.           other processes.
  75.  
  76.           _W_A_R_N_I_N_G: Giving a user permission to specify his or her  own
  77.           process  table will allow them to bypass all protection pro-
  78.           vided by INGRES.  This facility should be provided for  sys-
  79.           tem debugging only!
  80.  
  81.      EXAMPLE
  82.           The following example will execute a three process system.
  83.  
  84.               DB:$P/bin
  85.               DS:$P/source
  86.               ****  Process 0 -- terminal monitor
  87.               P0:$B/monitor:MONITOR:h:0003:M
  88.               L0:0:0:0
  89.               R1:0:a:h:0007:1
  90.               *  Process 1 -- parser
  91.               P1:$B/parser:PARSER:a:0014:P
  92.               L3:1:0:0
  93.               R0:0:h:a:0006:0
  94.               R2:0:b:g:0007:5:6:7
  95.               *  Process 2 -- data base utilities
  96.               P2:$B/alldbu:DBU:b:0014:Z
  97.               L5:0:6:0
  98.               L6:0:0:0
  99.               L7:0:1:0
  100.               R0:0:g:b:0000
  101.               R1:0:g:b:0006
  102.  
  103.  
  104.